W02-2. Docker 기본 - 실습 가이드
2주차 실습: 컨테이너 생명주기와 이미지 다루기
- 컨테이너를 만들고 → 켜고 → 얼리고 → 끄고 → 지우는 한 바퀴를 직접 돌린다.
stop과kill의 차이를 시간과 종료 코드로 확인한다.- 로그 보기, 안에 들어가기, 정보 조회, 재시작 정책을 손에 익힌다.
- 이미지의 CPU 종류, 레이어, 태그를 직접 들여다본다.
- Docker Desktop 실행 중 (Engine running)
- 터미널: macOS → 터미널 / Windows → PowerShell
- 명령어는 macOS 와 Windows 가 똑같습니다. 다른 부분만 따로 표시했습니다.
- 지난주 실습을 못 했다면 1주차 실습의 실습 1~3 만 먼저 해 보세요(10분).
| 실습 | 내용 | 시간 |
|---|---|---|
| 1 | 생명주기 한 바퀴 | 6분 |
| 2 | stop vs kill |
6분 |
| 3 | 메인 프로세스가 끝나면? | 3분 |
| 4 | 로그 보기 | 6분 |
| 5 | 실행 중인 컨테이너 안 들여다보기 | 4분 |
| 6 | 컨테이너 정보 조회 | 3분 |
| 7 | 재시작 정책 | 5분 |
| 8 | 이미지 들여다보기 | 8분 |
| 9 | 디스크 사용량과 정리 | 4분 |
실습 1. 생명주기 한 바퀴
상태가 바뀔 때마다 docker ps -a 로 STATUS 를 확인하는 것이 핵심입니다.
1-1. 만들기만 하기 (Created)
docker create --name study-life -p 8080:80 nginx:1.30-alpine
docker ps -a --filter name=study-life
출력 예시:
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
a1b2c3d4e5f6 nginx:1.30-alpine "/docker-entrypoint.…" 2 seconds ago Created study-life
--filter name=study-life는 이름에study-life가 들어간 것만 보여 달라는 뜻입니다.
지금 http://localhost:8080 에 접속하면 연결되지 않습니다. 아직 실행 전이기 때문입니다.
1-2. 실행하기 (Running)
docker start study-life
docker ps -a --filter name=study-life
STATUS: Up 2 seconds
브라우저에서 http://localhost:8080 을 열면 Welcome to nginx! 가 보입니다.
1-3. 얼리기 (Paused)
docker pause study-life
docker ps -a --filter name=study-life
STATUS: Up 30 seconds (Paused)
브라우저에서 http://localhost:8080 을 새로고침해 보세요. 페이지가 계속 로딩 중으로 멈춰 있습니다. 프로세스가 얼어 있어서 응답을 못 하는 것입니다.
1-4. 녹이기 (Running)
docker unpause study-life
로딩 중이던 브라우저가 바로 페이지를 보여 줍니다. 얼어 있는 동안 들어온 요청을 녹자마자 처리한 것입니다.
1-5. 끄기 (Exited) → 다시 켜기
docker stop study-life
docker ps -a --filter name=study-life
STATUS: Exited (0) 2 seconds ago → 종료 코드 0, 정상 종료입니다.
docker start study-life
docker restart study-life
docker ps -a --filter name=study-life
STATUS: Up 1 second → restart 는 "끄고 다시 켜기" 입니다.
1-6. 지우기
실행 중인 컨테이너를 그냥 지우면 어떻게 될까요?
docker rm study-life
출력 예시:
Error response from daemon: cannot remove container "study-life": container is running: stop the container before removing or force remove
실수로 실행 중인 서비스를 지우지 않도록 Docker 가 막아 줍니다. 끄고 지우거나,
-f로 강제로 지웁니다.
docker rm -f study-life
docker ps -a --filter name=study-life
목록이 비어 있으면 완료입니다. ✅
실습 2. stop vs kill
신호를 잘 처리하는 nginx 와, 신호를 무시하는 sleep 을 비교합니다.
docker run -d --name study-web -p 8080:80 nginx:1.30-alpine
docker run -d --name study-sleeper alpine:3.24 sleep 3600
2-1. 둘 다 stop -t 5 로 꺼 보기
-t 5 는 "SIGTERM 을 보낸 뒤 최대 5초 기다리고, 그래도 안 꺼지면 강제 종료" 라는 뜻입니다.
macOS:
time docker stop -t 5 study-web
time docker stop -t 5 study-sleeper
Windows (PowerShell):
Measure-Command { docker stop -t 5 study-web } | Select-Object TotalSeconds
Measure-Command { docker stop -t 5 study-sleeper } | Select-Object TotalSeconds
출력 예시 (Windows):
TotalSeconds
------------
0.4793079 ← nginx: 바로 꺼짐
4.9166402 ← sleep: 5초를 꽉 채워 기다림
macOS 는 출력 끝의
… total숫자를 보세요. nginx 는 1초 미만, sleep 은 약 5초입니다.
2-2. 종료 코드 비교
docker ps -a --filter name=study- --format "table {{.Names}}\t{{.Status}}"
출력 예시:
NAMES STATUS
study-sleeper Exited (137) 3 seconds ago
study-web Exited (0) 8 seconds ago
| 컨테이너 | 걸린 시간 | 종료 코드 | 무슨 일이 있었나 |
|---|---|---|---|
| study-web (nginx) | 1초 미만 | 0 | SIGTERM 을 받고 스스로 정리하고 종료 |
| study-sleeper (sleep) | 약 5초 | 137 | SIGTERM 을 무시 → 5초 뒤 SIGKILL 로 강제 종료 |
--format 이 뭔가요?
docker ps 출력에서 원하는 열만 골라 보여 줍니다. table 을 붙이면 제목 줄도 같이 나옵니다.
2-3. kill 은 기다리지 않는다
docker start study-sleeper
docker kill study-sleeper
docker ps -a --filter name=study-sleeper --format "{{.Names}}: {{.Status}}"
출력 예시:
study-sleeper: Exited (137) Less than a second ago
kill은 기다림 없이 즉시 강제 종료합니다. 운영 중인 서비스에는 먼저stop을 쓰세요.
정리합니다.
docker rm study-web study-sleeper
실습 3. 메인 프로세스가 끝나면?
docker run -d --name study-echo alpine:3.24 echo "hi"
docker run -d --name study-ubuntu-d ubuntu:26.04
2~3초 기다린 뒤 상태를 봅니다.
docker ps -a --filter name=study- --format "table {{.Names}}\t{{.Command}}\t{{.Status}}"
출력 예시:
NAMES COMMAND STATUS
study-ubuntu-d "/bin/bash" Exited (0) 3 seconds ago
study-echo "echo hi" Exited (0) 4 seconds ago
study-echo: 메인 프로세스echo hi가 글자를 찍고 끝났으니 컨테이너도 끝study-ubuntu-d: 메인 프로세스bash가 입력이 없어 할 일이 없으니 끝
꺼진 컨테이너라도 출력은 남아 있습니다.
docker logs study-echo
출력: hi
docker rm study-echo study-ubuntu-d
실습 4. 로그 보기
docker run -d --name study-web -p 8080:80 nginx:1.30-alpine
브라우저에서 아래 두 주소를 각각 2~3번씩 열어 봅니다.
- http://localhost:8080 (정상 페이지)
- http://localhost:8080/nothing (없는 페이지 → 404)
4-1. 전체 로그
docker logs study-web
출력 예시 (뒷부분):
172.17.0.1 - - [01/Oct/2026:04:52:40 +0000] "GET / HTTP/1.1" 200 896 "-" "Mozilla/5.0 ..." "-"
2026/10/01 04:52:40 [error] 33#33: *4 open() "/usr/share/nginx/html/nothing" failed (2: No such file or directory), ...
172.17.0.1 - - [01/Oct/2026:04:52:40 +0000] "GET /nothing HTTP/1.1" 404 153 "-" "Mozilla/5.0 ..." "-"
| 로그에서 읽을 수 있는 것 | 예 |
|---|---|
| 누가 접속했나 | 172.17.0.1 (Docker 내부 네트워크를 거쳐 들어온 내 브라우저) |
| 무엇을 요청했나 | GET /, GET /nothing |
| 결과는 | 200 (성공), 404 (없음) |
| 에러 내용 | [error] ... open() ... failed |
4-2. 마지막 몇 줄만 / 시간 표시
docker logs --tail 2 study-web
docker logs -t --tail 1 study-web
출력 예시 (-t): 맨 앞에 Docker 가 기록한 시간이 붙습니다.
2026-10-01T04:52:40.830131446Z 172.17.0.1 - - [...] "GET /nothing HTTP/1.1" 404 153 ...
4-3. 실시간으로 보기
docker logs -f study-web
이 상태에서 브라우저를 새로고침하면 터미널에 로그가 바로바로 올라옵니다.
다 봤으면 Ctrl + C 로 빠져나옵니다. 컨테이너는 계속 실행 중입니다.
컨테이너가 이상하면 제일 먼저 docker logs 를 봅니다. 대부분의 원인이 로그에 찍혀 있습니다.
실습 5. 실행 중인 컨테이너 안 들여다보기
docker exec 로, 실행 중인 study-web 안에서 명령을 실행합니다.
docker exec study-web nginx -v
docker exec study-web ls /usr/share/nginx/html
docker exec study-web env
출력 예시:
nginx version: nginx/1.30.5
50x.html
index.html
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
HOSTNAME=1d976fe04eb5
NGINX_VERSION=1.30.5
...
nginx -v: 이미지에 들어 있는 nginx 버전ls /usr/share/nginx/html: 웹 페이지 파일이 있는 곳env: 컨테이너의 환경 변수. 이미지를 만든 사람이 넣어 둔 값(NGINX_VERSION)이 보입니다. 환경 변수는 5주차부터 설정을 넘기는 데 씁니다.
셸로 들어가서 둘러볼 수도 있습니다. alpine 기반 이미지에는 bash 가 없어서 sh 를 씁니다.
docker exec -it study-web sh
컨테이너 안에서:
cat /etc/nginx/conf.d/default.conf
exit
exit로 나와도 컨테이너는 계속 실행 중입니다. 메인 프로세스(nginx)가 아니라 추가로 띄운 셸만 끝났기 때문입니다.
실습 6. 컨테이너 정보 조회
docker inspect 는 컨테이너의 모든 설정과 상태를 보여 줍니다. 그대로 실행하면 매우 길어서, 필요한 값만 골라 봅니다.
docker inspect --format "{{.State.Status}}" study-web
docker inspect --format "{{.Config.Image}}" study-web
docker inspect --format "{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}" study-web
docker port study-web
출력 예시:
running
nginx:1.30-alpine
172.17.0.2
80/tcp -> 0.0.0.0:8080
80/tcp -> [::]:8080
| 명령 | 알 수 있는 것 |
|---|---|
.State.Status |
현재 상태 |
.Config.Image |
어떤 이미지로 만들었나 |
range .NetworkSettings.Networks |
컨테이너의 내부 IP (3주차 네트워크에서 다시 봅니다) |
docker port |
바깥 포트와 컨테이너 포트의 연결 |
docker inspect --format "{{.NetworkSettings.IPAddress}}" 라는 명령이 많이 나옵니다. Docker 29 에서는 에러가 납니다.
template parsing error: ... map has no entry for key "IPAddress"
위처럼 range .NetworkSettings.Networks 를 쓰세요.
정리합니다.
docker rm -f study-web
실습 7. 재시작 정책
nginx 컨테이너 안에서 nginx -s stop 을 실행하면 메인 프로세스를 직접 끌 수 있습니다. 앱이 갑자기 죽는 상황을 흉내 내는 것입니다.
7-1. 재시작 정책 없음 (기본값)
docker run -d --name study-norestart nginx:1.30-alpine
docker exec study-norestart nginx -s stop
2~3초 기다린 뒤:
docker ps -a --filter name=study-norestart --format "{{.Names}}: {{.Status}}"
출력 예시: 죽은 채로 있습니다.
study-norestart: Exited (0) 2 seconds ago
7-2. unless-stopped
docker run -d --name study-restart --restart unless-stopped nginx:1.30-alpine
docker exec study-restart nginx -s stop
2~3초 기다린 뒤:
docker ps -a --filter name=study-restart --format "{{.Names}}: {{.Status}}"
docker inspect --format "RestartCount={{.RestartCount}}" study-restart
출력 예시: Docker 가 다시 살려 냈습니다.
study-restart: Up 3 seconds
RestartCount=1
7-3. 사람이 stop 한 것은 존중한다
docker stop study-restart
몇 초 기다린 뒤 다시 확인합니다.
docker ps -a --filter name=study-restart --format "{{.Names}}: {{.Status}}"
출력 예시: 이번에는 살아나지 않습니다.
study-restart: Exited (0) 5 seconds ago
정리합니다.
docker rm study-norestart study-restart
실습 8. 이미지 들여다보기
8-1. 새 이미지 받기
Apache 웹 서버 이미지를 받아 봅니다.
docker pull httpd:2.4-alpine
출력 예시 (끝부분):
Status: Downloaded newer image for httpd:2.4-alpine
docker.io/library/httpd:2.4-alpine
마지막 줄을 보세요. 우리가 쓴
httpd:2.4-alpine의 전체 이름(docker.io/library/…)이 나옵니다.
8-2. 내 노트북용으로 받은 이미지의 CPU 종류
docker image inspect --format "OS={{.Os}} Arch={{.Architecture}} Layers={{len .RootFS.Layers}}" nginx:1.30-alpine
출력 예시:
| 노트북 | 출력 |
|---|---|
| Windows / Intel Mac | OS=linux Arch=amd64 Layers=8 |
| Apple Silicon Mac | OS=linux Arch=arm64 Layers=8 |
옆 사람과 비교해 보세요. 같은 이름의 이미지인데 CPU 종류가 다릅니다. (Layers 숫자는 CPU 종류에 따라 다를 수도 있습니다.)
8-3. 이 태그에 들어 있는 CPU 별 이미지 목록
macOS:
docker buildx imagetools inspect nginx:1.30-alpine | grep "Platform:"
Windows (PowerShell):
docker buildx imagetools inspect nginx:1.30-alpine | Select-String "Platform:"
출력 예시:
Platform: linux/amd64
Platform: unknown/unknown
Platform: linux/arm/v6
Platform: unknown/unknown
Platform: linux/arm/v7
Platform: unknown/unknown
Platform: linux/arm64/v8
Platform: unknown/unknown
Platform: linux/386
...
linux/amd64,linux/arm64/v8처럼 생긴 줄이 CPU 별 이미지입니다. 태그 하나에 8가지가 들어 있습니다.unknown/unknown은 이미지가 아니라 어떻게 만들었는지에 대한 증명서(attestation)입니다. 무시해도 됩니다.
8-4. 이미지가 만들어진 과정 (레이어)
docker image history nginx:1.30-alpine
출력 예시 (앞부분):
IMAGE CREATED CREATED BY SIZE COMMENT
0985e772fb9f 8 days ago RUN /bin/sh -c set -x && apkArch="$(cat … 51.9MB buildkit.dockerfile.v0
<missing> 8 days ago ENV ACME_VERSION=0.4.1 0B buildkit.dockerfile.v0
...
<missing> 8 days ago CMD ["nginx" "-g" "daemon off;"] 0B buildkit.dockerfile.v0
<missing> 8 days ago STOPSIGNAL SIGQUIT 0B buildkit.dockerfile.v0
<missing> 8 days ago EXPOSE map[80/tcp:{}] 0B buildkit.dockerfile.v0
...
CREATED BY 열이 이미지를 만든 명령어 한 줄 한 줄입니다. 이 명령어들을 모아 놓은 파일이 Dockerfile 입니다.
CMD ["nginx" "-g" "daemon off;"] 가 바로 이 이미지의 메인 프로세스입니다(실습 3).
STOPSIGNAL SIGQUIT 는 nginx 를 끌 때 SIGTERM 대신 nginx 가 좋아하는 신호를 보내라는 설정입니다. 실습 2에서 nginx 가 바로 꺼진 이유 중 하나입니다.
8-5. 태그 붙이기와 지우기
docker tag nginx:1.30-alpine study-nginx:mytag
docker image ls --filter reference=nginx:1.30-alpine --filter reference=study-nginx
출력 예시:
IMAGE ID DISK USAGE CONTENT SIZE EXTRA
nginx:1.30-alpine 0985e772fb9f 93.6MB 27MB
study-nginx:mytag 0985e772fb9f 93.6MB 27MB
EXTRA열에U가 보이면 그 이미지를 쓰는(In Use) 컨테이너가 있다는 뜻입니다.
docker tag 는 이미지를 복사하는 게 아니라 이름표를 하나 더 붙이는 것입니다. 디스크를 더 쓰지 않습니다.
이름표를 떼어 냅니다.
docker image rm study-nginx:mytag
출력: Untagged: study-nginx:mytag → 이름표만 떨어지고, 원본 nginx:1.30-alpine 은 그대로입니다.
8-6. 쓰는 중인 이미지는 지울 수 없다
docker run -d --name study-httpd httpd:2.4-alpine
docker image rm httpd:2.4-alpine
출력 예시:
Error response from daemon: conflict: unable to delete httpd:2.4-alpine (must be forced) - container be43964d98d7 is using its referenced image 4e585da9d012
컨테이너를 먼저 지우면 이미지도 지울 수 있습니다.
docker rm -f study-httpd
docker image rm httpd:2.4-alpine
출력 예시:
Untagged: httpd:2.4-alpine
Deleted: sha256:4e585da9d0125dec36d4500a9f5c5df7b2c0a01f67cb47865a91a4b05bdbec1b
실습 9. 디스크 사용량과 정리
docker system df
출력 예시: 숫자는 사람마다 크게 다릅니다.
TYPE TOTAL ACTIVE SIZE RECLAIMABLE
Images 5 0 280MB 280MB (100%)
Containers 0 0 0B 0B
Local Volumes 0 0 0B 0B
Build Cache 0 0 0B 0B
| 열 | 의미 |
|---|---|
| TOTAL | 전체 개수 |
| ACTIVE | 컨테이너가 쓰고 있는 개수 |
| RECLAIMABLE | 지우면 되찾을 수 있는 용량 |
오늘 만든 컨테이너 한 번에 정리
이름이 study- 로 시작하는 컨테이너만 골라 지웁니다.
docker rm -f $(docker ps -aq --filter name=study-)
docker ps -aq --filter name=study-는study-컨테이너의 ID 만 뽑아 줍니다(-q= quiet).$( … )는 그 결과를 앞 명령에 넣어 줍니다. macOS(zsh)와 Windows PowerShell 에서 똑같이 동작합니다.- 지울 컨테이너가 하나도 없으면
docker: 'docker rm' requires at least 1 argument가 나옵니다. 이미 깨끗하다는 뜻이니 괜찮습니다.
docker ps -a --filter name=study-
목록이 비어 있으면 정리 끝입니다. ✅
이미지(nginx:1.30-alpine, alpine:3.24, ubuntu:26.04)는 다음 주에도 쓰니 지우지 않습니다.
자주 나는 문제와 해결
| 증상 | 원인 | 해결 |
|---|---|---|
docker run -d ubuntu:26.04 가 바로 Exited |
메인 프로세스가 할 일이 없음 | 정상입니다(실습 3). 계속 띄우려면 sleep 3600 처럼 오래 도는 명령을 줍니다 |
docker exec -it ... bash 에서 executable file not found |
alpine 기반 이미지에는 bash 가 없음 | sh 를 씁니다 |
docker logs -f 에서 빠져나올 수 없음 |
- | Ctrl + C. 컨테이너는 계속 실행됩니다 |
cannot remove container ... container is running |
실행 중인 컨테이너는 그냥 못 지움 | docker stop 후 docker rm, 또는 docker rm -f |
unable to delete ... container ... is using its referenced image |
그 이미지로 만든 컨테이너가 남아 있음 (멈춘 것 포함) | docker ps -a 로 찾아서 컨테이너부터 지움 |
map has no entry for key "IPAddress" |
예전 자료의 명령(Docker 29 에서 바뀜) | {{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}} 사용 |
Windows 에서 --format 결과가 이상함 |
Git Bash 사용 | PowerShell 사용 |
오늘 쓴 명령어 정리
| 분류 | 명령어 | 하는 일 |
|---|---|---|
| 생명주기 | docker create / start / stop / restart |
만들기 / 켜기 / 끄기 / 재시작 |
docker pause / unpause |
얼리기 / 녹이기 | |
docker kill |
즉시 강제 종료 | |
docker stop -t 5 |
SIGTERM 후 최대 5초 기다림 | |
| 조회 | docker ps -a --filter name=... --format "..." |
조건에 맞는 컨테이너만, 원하는 열만 |
docker logs [-f] [--tail N] [-t] |
로그 보기 | |
docker exec [-it] <이름> <명령> |
실행 중인 컨테이너 안에서 명령 실행 | |
docker inspect --format "{{...}}" |
설정과 상태에서 원하는 값만 | |
docker port <이름> |
포트 연결 확인 | |
| 운영 | docker run --restart unless-stopped |
죽으면 다시 켜기 |
| 이미지 | docker pull / docker image ls |
받기 / 목록 |
docker image inspect / docker image history |
정보 / 만들어진 과정 | |
docker buildx imagetools inspect |
태그에 든 CPU 별 이미지 목록 | |
docker tag / docker image rm |
이름표 붙이기 / 떼기·삭제 | |
| 정리 | docker system df |
디스크 사용량 |
docker rm -f $(docker ps -aq --filter name=study-) |
study- 컨테이너 한 번에 삭제 |
복습 과제
확인 퀴즈
docker run은 어떤 두 명령을 합친 것인가요?- 실습 2에서 nginx 는 바로 꺼지고 sleep 은 5초가 걸렸습니다. 왜 그런가요? 종료 코드는 각각 무엇이었나요?
docker run -d ubuntu:26.04를 실행하면 컨테이너가 바로 Exited 가 됩니다. 이유는?--restart unless-stopped로 띄운 컨테이너를docker stop으로 끄면 다시 살아나나요?docker tag nginx:1.30-alpine study-nginx:mytag를 하면 디스크 사용량이 두 배가 되나요?- Windows 노트북과 Apple Silicon Mac 이 같은
nginx:1.30-alpine을 받았는데 CPU 종류가 다릅니다. 어떻게 가능한가요?
docker create+docker start(이미지가 없으면docker pull까지 자동으로 함)- nginx 는 종료 신호를 받고 스스로 정리하고 종료(종료 코드 0)했습니다. sleep 은 SIGTERM 을 무시해서, Docker 가 5초를 기다린 뒤 SIGKILL 로 강제 종료(종료 코드 137)했습니다.
- 메인 프로세스인
bash가 입력이 없어서 바로 끝났기 때문입니다. 메인 프로세스가 끝나면 컨테이너도 끝납니다. - 살아나지 않습니다.
unless-stopped는 사람이 직접 끈 것은 존중합니다(always와의 차이). - 아닙니다. 같은 이미지(같은 ID)에 이름표만 하나 더 붙는 것입니다.
- 태그 하나에 CPU 별 이미지가 여러 개 들어 있고(멀티 플랫폼 이미지), Docker 가
pull할 때 내 CPU 에 맞는 것을 자동으로 골라 받기 때문입니다.
도전 과제 (선택)
docker run -d --name study-oneshot --restart on-failure:3 alpine:3.24 sh -c "echo failed!; exit 1"을 실행하고, 15초쯤 뒤에 아래를 확인해 보세요. 몇 번 다시 시도했나요? 왜 멈췄을까요?docker ps -a --filter name=study-oneshot --format "{{.Names}}: {{.Status}}" docker inspect --format "RestartCount={{.RestartCount}}" study-oneshot docker logs study-oneshot- Docker Desktop 대시보드의 Images 화면에서
nginx:1.30-alpine을 눌러 보세요. 오늘 터미널로 본 레이어 목록이 화면에도 나옵니다. - 다 했으면
docker rm -f study-oneshot으로 정리합니다.
지금까지는 컨테이너를 지우면 데이터가 사라졌고, 컨테이너끼리는 서로를 몰랐습니다.
다음 주에는 데이터를 컨테이너 밖에 보관하는 법(볼륨) 과 컨테이너끼리 이름으로 통신하는 법(네트워크) 을 배웁니다.
네비게이션
| 이전 | 목록 | 다음 |
|---|---|---|
| ◀ 2주차 강의 노트 | 목록으로 | 3주차 강의 노트 ▶ |